home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / bbs / mxgui203.zip / MXGUI203.DOC < prev    next >
Text File  |  1997-08-16  |  14KB  |  259 lines
  1. ╔═════════════════════════════════════════════════════════════════════════════╗
  2. ║      FIRST THINGS FIRST - READ THE FILE WARNING.TXT BEFORE PROCEEDING!      ║
  3. ╚═════════════════════════════════════════════════════════════════════════════╝
  4.  
  5.                              ┌╦══╦┐ ┌╦══╦┐ ┌╦═══╦┐
  6.                              │╠══╩╗┐│╠══╩╗┐└╩═══╦┐
  7.                              └╩═══╩┘└╩═══╩┘└╩═══╩┘
  8.         ┌╦   ╦┐┌═╤╦╤═┐┌═╤╦╤═┐┌╔     ┌═╤╦╤═┐┌═╤╦╤═┐┌╔═══╦┐┌╔═══╦┐┌════╦┐
  9.         │║   ║│  │║│    │║│  │║       │║│    │║│  │╬══   │╬══   ┌─╔═╝─┘
  10.         └╩═══╩┘  ╧╩╧  └═╧╩╧═┘└╩═══╩┘└═╧╩╧═┘  ╧╩╧  └╩═══╩┘└╩═══╩┘└╚════┘
  11.             ┌╦═══╦┐┌╦═══╦┐┌╔═══╦┐┌═╤╦╤═┐┌╦   ╦┐┌╦═══╦┐┌╦═══╦┐┌╔═══╦┐
  12.             └╩═══╦┐│║   ║││╬══     │║│  │║ ╦ ║│├╬═══╬┤│╠══╦╩┘│╬══
  13.             └╩═══╩┘└╩═══╩┘└╩       ╧╩╧  └╩═╩═╩┘└╩   ╩┘└╩  ╚═┘└╩═══╩┘ <tm>
  14.  
  15.                             A Subsidary Of LA-Soft
  16.  
  17. ───────────────────────────────────────────────────────────────────────────────
  18.   ▀▀▀   ▀▀▀   ▀▀▀▀▀   ▀▀   ▀▀
  19.   ▀▀▀▀ ▀▀▀▀  ▀▀   ▀▀   ▀▀ ▀▀
  20.   ▀▀ ▀▀▀ ▀▀  ▀▀▀▀▀▀▀    ▀▀▀    ╔══ ╦═╗ ╔═╗ ╦═╗ ╦ ╦ ╦ ╔═╗ ╔═╗
  21.   ▀▀  ▀  ▀▀  ▀▀   ▀▀   ▀▀ ▀▀   ║ ╦ ╠╦╝ ╠═╣ ╠═╝ ╠═╣ ║ ║   ╚═╗
  22.   ▀▀     ▀▀  ▀▀   ▀▀  ▀▀   ▀▀  ╚═╝ ╩╚═ ╩ ╩ ╩   ╩ ╩ ╩ ╚═╝ ╚═╝  v2.03
  23. ───────────────────────────────────────────────────────────────────────────────
  24.   The MAX Graphics GUI kit is Copyright 1995-Current Larry L. Athey (LA-Soft).
  25.   Color Averaging procedures are courtesy of Sean Price (Rude Dog Software).
  26. ───────────────────────────────────────────────────────────────────────────────
  27.  
  28.   Information Regarding MAX Graphics:
  29.   ───────────────────────────────────
  30.   Notice is hereby given that the MAXscript/MAXcontrol/MAXcolor language,
  31.   and MAXterm are products of BBS Utiliteez Software and are protected by
  32.   US copyrights listed with the US Library Of Congress (1996)....
  33.  
  34.   No changes, additions, subtractions, or other modifications shall be made
  35.   to MAXscript/MAXcontrol/MAXcolor language or the MAX Graphics development
  36.   kit without express written permission from Larry L. Athey, BBS Utiliteez
  37.   Software, Alliance, Nebraska, USA....
  38.  
  39.   The MAXscript/MAXcontrol/MAXcolor language may be used in any BBS or Door
  40.   software 100% royalty free. You are also allowed to implement full local
  41.   graphics viewing in any BBS or Door software 100% royalty free. However,
  42.   any program that uses the MAXscript/MAXcontrol/MAXcolor language *MUST*
  43.   bear the MAX Graphics/BBS Utiliteez Software copyright notice....
  44.  
  45.  
  46.   Example: MAX Graphics and the MAXscript/MAXcontrol/MAXcolor language is
  47.              (C) 1995-Current * Larry L. Athey * BBS Utiliteez Software
  48.  
  49. ───────────────────────────────────────────────────────────────────────────────
  50.  
  51.   Special Notes:
  52.   ──────────────
  53.   Unlike the majority of MAX Graphics related programs, the source code to the
  54.   MAX Graphics GUI Kit is not included...This wasn't done this way because I'm
  55.   trying to hide anything or have any secrets...This is only done this way for
  56.   the sake of preventing a standard from becoming a non-standard...
  57.  
  58.   You should not use this kit until you have become familiar with TDK, and the
  59.   MAXscript/MAXcontrol/MAXcolor language...You do not have to be any kind of a
  60.   programming wizard to use this kit, but if you just dive into writing a door
  61.   with this kit and have no prior knowledge of the two, you'll most likely end
  62.   up throwing in the towel due to frustration...
  63.  
  64. ───────────────────────────────────────────────────────────────────────────────
  65.  
  66.   Files Included In This Archive:
  67.   ───────────────────────────────
  68.   All unit files have an accompanying *.TXT file that shows the procedure and
  69.   function names...The MAX Graphics GUI Kit is also dependent on the TDK door
  70.   development kit so you will need to adjust your compiler directory settings
  71.   in order to make those units accessible by these units. As always, this kit
  72.   (just like TDK) requires Borland/Turbo Pascal v7.0...
  73.  
  74.   Lastly, the MAX Graphics GUI Kit is fully dependent on the FastGraph kit by
  75.   Ted Gruber Software. You may use the full FastGraph kit, or FastGraph Light
  76.   with this kit. BBS Utiliteez Software & LA-Soft and Ted Gruber Software are
  77.   in no way connected, this kit is simply dependent on one of their kits. For
  78.   more information on FastGraph, please contact:
  79.  
  80.   Ted Gruber Software
  81.   P.O. Box 13408
  82.   Las Vegas, Nevada, 89112
  83.   Voice  - (702)735-1980
  84.   Fax    - (702)735-4603
  85.   WWW    - http://www.fastgraph.com
  86.   E-Mail - fastgraph@aol.com
  87.  
  88.   Ted Gruber Software, and the shareware version of the FastGraph package has
  89.   its own policies and rules...In no way whatsoever does the freeware concept
  90.   of MAX Graphics apply to Ted Gruber Software or the FastGraph package...
  91.  
  92.   This copy of The MAX Graphics GUI Kit is only designed to compile with the
  93.   unregistered shareware version of FastGraph/Light. When you have purchased
  94.   the full version of FastGraph (not FastGraph/Light), please contact me and
  95.   I will make a custom compiled version of The MAX Graphics GUI Kit for you.
  96.   If you try to compile this kit with anything but the FastGraph/Light v4.04
  97.   shareware archive, you will end up with up with unit version mismatches...
  98.  
  99.   You may freq the magic name "FASTGRAPH" from 1:14/703 for the most current
  100.   FastGraph/Light shareware archive if you do not have internet access...
  101.  
  102.  
  103.   _SCRIPT.TPU  - This is the MAXscript/MAXcontrol/MAXcolor interpreter unit
  104.                  that parses MAX commands and turns them into local graphics.
  105.  
  106.   GUI_ANSI.TPU - This is the SVGA ANSI emulation unit used for text view ports
  107.   GUI_ANSI.TXT   and regular graphical ANSI emulation in MAXterm.
  108.  
  109.   GUI_FONT.TPU - This is the GEM font support unit.
  110.   GUI_FONT.TXT
  111.  
  112.   GUI_ICON.TPU - This is the MAX Graphics icon support unit.
  113.   GUI_ICON.TXT
  114.  
  115.   GUI_IMAG.TPU - This is the PCX/BMP/MIF/FLI image support unit. If you want
  116.   GUI_IMAG.TXT   to support MIF images in your programs, the MIF.EXE program
  117.                  will need to be distributed with your programs.
  118.  
  119.   GUI_MOUS.TPU - This is the main mouse support unit.
  120.   GUI_MOUS.TXT
  121.  
  122.   GUI_UNIT.TPU - This is the meat and potatos of the MAX Graphics GUI Kit,
  123.   GUI_UNIT.TXT   this unit contains the main system procedures/functions
  124.                  as well as all of the GUI specific variables/records.
  125.  
  126.   GUI_UTIL.TPU - This is the utility unit, this unit contains all of the
  127.   GUI_UTIL.TXT   string/number/file handling procedures/functions.
  128.  
  129.   MAINMENU.MAX - This is an external MAX screen file which is used by the
  130.                  the example MAX door program.
  131.  
  132.   MAXDOOR.EXE  - This is a sample door program that can be compiled to use
  133.   MAXDOOR.PAS    local SVGA graphics and no communications routines, or it
  134.   MAXDOOR.INC    can be compiled the other way with no local SVGA graphics
  135.                  and communications routines.
  136.  
  137.   MAXSOUND.EXE - This is the MAX Graphics sound file player program. This is
  138.                  intentionally made an external program because the buffers
  139.                  used to play the sound files kills the program data segment,
  140.                  even if they are NEW'ed/DISPOSE'd in pointer arrays. Aren't
  141.                  real mode programs a peach to deal with?  :)
  142.  
  143.   MAXUNITG.PAS - This is a dummy unit to handle the procedures and functions
  144.                  that would normally be handled by the TDK units: MAX_UNIT,
  145.                  DOORKIT1, and DOORKIT3. The concept behind the MAX Graphics
  146.                  GUI Kit is that you comment out the three units listed in
  147.                  the above and place this unit at the end of the USES clause
  148.                  of your main program/units. This way you can write the SVGA
  149.                  side to your doors in local graphics mode, and when they're
  150.                  fully debugged, you then comment out this unit and uncomment
  151.                  the other units. Recompile the program with the TDK units
  152.                  back in place and you'll have a fully functional MAX'ed out
  153.                  door. Depending on how you write your doors, you may have to
  154.                  modify this unit, therefore the source code is included...
  155.  
  156.   MIF.EXE      - As with the MAXSOUND.EXE program, this program is also made
  157.                  external for the same reasons. This program is used to read
  158.                  a *.MIF image file and decompress it into readable data.
  159.  
  160.   SYSTEM.OBJ   - These are font object files used for MAX font types 1 & 2.
  161.   BIT5X8.OBJ     These files are automatically linked into your code when
  162.                  you compile the program so you never have to included the
  163.                  files with your programs. MAX font type 3 is derived from
  164.                  the ROM, so no external font object file is needed for it.
  165.  
  166.   PALETTE.DAT  - This is the MAX Graphics color palette settings file. This
  167.                  is used to set the video DACs when the SVGA mode fires up.
  168.                  If you distribute any programs that run in SVGA mode, you
  169.                  will need to include this file with every program archive.
  170.  
  171. ───────────────────────────────────────────────────────────────────────────────
  172.  
  173.   System Preparation:
  174.   ───────────────────
  175.   After you have installed TDK, FastGraph, and The MAX Graphics GUI Kit, you
  176.   will need to designate a directory to use as a "Session Path" and put all
  177.   of your resource files there. The default path for this is \SESSION\ which
  178.   is immediately below your main program directory. However, you can change
  179.   this to any path that you choose by modifying the initialization portion
  180.   of MAXUNITG. This unit is just set up so that it uses the same directories
  181.   as MAXterm does. In this session path, you will need to at least have the
  182.   bare minimum of the ICON_LIB.* libraries from MAXterm's DEFAULT.PKG, just
  183.   PKUNZIP this file to your session path and that's all you'll need. You can
  184.   add more resources later on as necessary...
  185.  
  186.   You may also specify a session path on the command line. The existence of
  187.   this path as well as the existence of the default MAX icon libraries will
  188.   be checked at start up time...If any of these items don't exist, the door
  189.   will exit with an error message on the screen...
  190.  
  191.   If you are using Turbo Pascal v7.0 and experience "Out Of Memory" errors
  192.   when compiling a local SVGA MAX door, you may want to consider upgrading
  193.   to Borland Pascal With Objects v7.0 instead...The problem with the Turbo
  194.   Pascal package is that the IDE and compiler are "Real Mode" programs and
  195.   BP7.0 uses a "Protected Mode" IDE and compiler. The BP7.0 protected mode
  196.   IDE and compiler uses all of your memory rather than just your remaining
  197.   conventional memory. Upgrading to BP7.0 definitely has its benefits, and
  198.   will allow you to compile much larger programs...
  199.  
  200. ───────────────────────────────────────────────────────────────────────────────
  201.  
  202.   How It All Works:
  203.   ─────────────────
  204.   As mentioned in the file descriptions in the above, the MAXUNITG.PAS unit
  205.   is used to simulate procedures and functions in DOORKIT1.PAS, DOORKIT3.PAS
  206.   and MAX_UNIT.PAS...Since you are writing a door with MAX Graphics support,
  207.   you will need a way of testing things without the need to call in to your
  208.   BBS with MAXterm. That's exactly what this kit allows you to do. You just
  209.   modify your main program and all units and comment out references to the
  210.   DOORKIT1.PAS, DOORKIT3.PAS and MAX_UNIT.PAS units, then at the tail end of
  211.   the USES clause you add a unit reference to MAXUNITG. Recompile your door
  212.   and when it starts up, it will automatically be running in SVGA mode with
  213.   the Graphics variable set to MAX. You will now see everything exactly the
  214.   same way that a MAXterm caller will see it...
  215.  
  216.   Keep in mind that you should NEVER under any circumstances try to compile
  217.   and run a door with DOORKIT1, DOORKIT3, MAX_UNIT, and MAXUNITG together!!
  218.   Your door will not run, and you will most likely end up with a locked up
  219.   computer. MAXUNITG is only intended for testing purposes, your doors can
  220.   only have comm routines with no SVGA, or SVGA with no comm routines, this
  221.   is critical!!
  222.  
  223.   As you can see by the USES clause in MAXDOOR.PAS, the only units used by
  224.   the program when in SVGA mode are DOORKIT2.PAS and TDK_VARS.PAS, none of
  225.   the other TDK units are used. You will also notice by running the door
  226.   that it doesn't support the normal command line parameters in TDK, nor
  227.   does this door support any of the sysop F-Keys. Since this is a "Local
  228.   Only" door, there is no need for any of this other stuff. Not even the
  229.   node control file is read when running the door, all of this is taken
  230.   care of in the initialization portion of the MAXUNITG.PAS unit. You will
  231.   need to change these variables to suit your needs if the default settings
  232.   are not desired...
  233.  
  234.   After you have debugged the MAX side of your door, simply comment out the
  235.   MAXUNITG.PAS unit, and uncomment the other units you previously removed.
  236.   Recompile your door and that's all there is to it, it's just too simple...
  237.  
  238. ───────────────────────────────────────────────────────────────────────────────
  239.  
  240.   Important Note About Sound Support:
  241.   ───────────────────────────────────
  242.   Be absolutely sure that you adjust the variables in the initialization
  243.   portion of MAXUNITG.PAS to match your existing SoundBlaster settings, or
  244.   else you will lock up your computer as soon as you attempt to play any
  245.   sound files. If you don't have a SoundBlaster installed, you will want
  246.   to copy the file MIF.EXE over top of the file MAXSOUND.EXE...
  247.  
  248. ───────────────────────────────────────────────────────────────────────────────
  249.  
  250.                 For an authentic copy of this program, see below:
  251.  
  252.      ┌───────────────────────────────────────────────────────────────────┐
  253.      │ Contact: 1:14/703@FidoNet             Or: USA MAX Graphics HQ-BBS │
  254.      │          411:1500/0@ivNET                 (308)762-2239           │
  255.      │          121:101/2@AllianceNet            FAX or Data Calls       │
  256.      │          maxgfx@juno.com                  ANSI/ASCII/MAX (No RIP) │
  257.      └───────────────────────────────────────────────────────────────────┘
  258.  
  259.